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PRODUCT DESCRIPTION 

This two disk package is being made available in response for specific requests for 
an interface between valFORTH and the standard Atari Disk Operating System (DOS) 
format. With this package, FORTH screens need never be used again. The package 
is composed of three basic subpackages: 

A complete set of system level disk input/output operations is provided. 

More specifically, files can be created, opened, closed, read/written on 
a byte/block basis, end-filed, rewound, eof, spaced through in either 
direction, locked, unlocked, killed, and renamed. Other system commands 
which aid in filename conversion, and directory scanning are also supplied. 
These are for use in user written programs. 

A complete set of file manipulation commands which includes CLOSE, COPT, 

DIR, DISKCOPYn, ENDFIL, EOF, ENTER, FDUMP, FILE-IT, FLOAD, FMGVE, FORMAT, 
FSPACE, KILL, NAMEDISK, OPEN, OPEN?, PRINT, READ, RENAME, REWIND, SETUNIT, 
UNLOCK, and WRITE. The PRINT command sends a specified file to the current 
output device. The FDUMP command performs a hex/ASCI I dump of a specified 
file. Most of these commands accept wild-card names and multiple arguments 
for ease in program development. 

Finally, an expanded file editor based on the already powerful editor de¬ 
scribed in the General/Utilities package is supplied. The following en¬ 
hancements are included: true forward/backward scrolls, global searches, 
splices, tab setting/resetting, command repeat mode, immediate file inser¬ 
tion, and a useful subcommand mode. This is in addition to allthe features 
found in the valFORTH Video Editor 1.1. 

This package is designed so that random access can easily be added sometime in the 
future. 


Requires valFORTH 1,1 
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PRODUCT DESCRIPTION 

The Display Formatter gives the programmer virtually instant 
access to the Antic processor in the Atari 400/900- 

Essential ly, this package is a very smart assembler for Antic, ■, 
and takes care of all housekeeping chores associated with 4K 
memory boundaries, display memory allocation, programming Antics 
for display list interrupts, horizontal and vertical scrolling,,, 
wait-vertical blank, and so on- Also allows dynamic 

reformatting of display lists during application execution 4f 
desired, or creating one display list while display ■ vU a 
second one. The documentation contains tabular information 
about different Antic modes consolidated from various sources 
and step-by-step display list construction examples. — ^ 

' '...-.I tfi?. 

This package is one that probably should have been p*rov v ided 
with the machine itself- • *-». • 

.. y 'f f , 

30 pages of documentation. Requires valFORTH 1.1 
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PRODUCT DESCRIPTION 

This package addresses three of the many special capabilities 
of Otari 400/000. 

The Playei—Missile Graphics package essentially writes the book 
on how to create and manipulate PM’s from high-level code. The 
} package itself is approximately 75* machine codes Practically 
any rbutine that has anything to do with the speed of operation 
f iS’ ; machine-coded. OLL P/M options are supported, and a 
uniquely useful automatic bounding function is included in the 
routines to confine the PM 1 s within rectangular areas with 
no Additional runtime overhead, should the user so desire. 
This package includes: 

commands to create, move, color, multicolor, bound, and 
animate (by image swapping) P/M’s, with full support of 
4player/4 missile or 5 player option, player/missile 
width commands, single or double resolution (height) 
option, collision-detection support, and automatic or 
user-selected memory allocation. 

The Character Editor is a joystick-driven program that allows 
composition on an 8 by 0 grid of character pixels with 
simultaneous display of the characters in graphics 8 mode. 
Character sets may be stored to and retrieved from disk by this 
editor and may be used as either character images or (parts of) 
player/missile images as desired. 

The Sound Editor is also a joystick-driven program that allows 
fast, simple creation of any possible combination of 
single-setting sounds on the Atari 400/800. The programmer 
’•flies” voices, represented by a graphics 2 colored numeral, 
over the display to determine pitch and distortion. Volume may 
be adjusted individually for each voice by the up/down arrow 
keys. The bits of AUDCTL (the register which enables all of 
the additional audio tricks like high-pass filtering and 
extended frequency range) can be toggled individually by the 
keys 0-7. A continous readout of each parameter of each voice, 
and the bits of AUDCTL, is displayed in the text window at the 
bottom of the screen. This program is very entertaining by 
itself, and up to 4 ”programmers” can create sounds at once, 
each with a joystick. 

The entire package is very tight and convenient. The 
implementation of PM Graphics will almost certainly never be 
improved upon, and rarely equaled. 


Over 35 pages of documentat ion. Requires valFORTH 1.1. 



ValFORTH Software System for Atari 400/800 

The valFORTH software system for Atari 400/800 consists of a 
bootable core package called valFORTH 1.1 and a number of 
additional packages that load on top of valFORTH 1.1. At this 
writing, the additional packages are: 

Available from Stock: . 

Utilities/Editor 
PIayer/Missile Graphics 
Display Formatter 

Turtle/val Graphics and Advanced Floating Point 
Text Compression and Auto Text Formatting 


valDOS (10/82) 

Descriptions of these packages follow. Data on packages not 
yet released are preliminary. V V. 









How about guarantees? 


j 


Defective media is covered fol 30 days from date of purchase. Replacement 
thereafter is subject to a nominal disk swap charge of $12.00, plus postage and 


valFORTH alone requires 24K. valFORTH 
Memory requirements include 10-12K 


CaII ^flnnLt;7fl-7p7p f^i^na, Hijf.l..7Qru7i 45E) and tell 
t hat ynil hflV° A torfrniral rf.inrfirih ■ UWJ mpT lL- 

Cost and Ordering Information : ^ 

There are currently seveih packages available. These are described in the attached 
pages and are: valFORTH 1.1 ( s $59.95), General Utilities and Video Editor ($49.95), 

Player Missile Graphics ($49’.95K,Display Formatter ($39.95), Turtle and valGRAPHICS ($54.95), 
Text Compression ($39.95), and valDpS ($59.95).*, 

y : : >; •• . ■ 

If you order three or more software packages at one time, a professional binder is 
included at no charge'. As of't)|cember 1, 1982,1;Valpar is no longer offering a $15.00 
credit for probf of purchase FORTH. PIeasfr note thf^change. Also as of 

December 1, 1982, we will no longer be offering the introductory full set price of $203.00 
for customers who order ValFfifftm 1. 1| through T)sxt Compression. The full price of $294.70 
will be charged. The* book,| Smarting' Forth , iSj an accessory that we sell for your convenience 
for $15.95. It comes with Wr own "Notes on Starting Forth for the Fig-Forth User." 

r - The costs llistbd abov‘e do not Include shipping, handling, and insurance. We ship 
by Untied Parcel Servifcb^unl|^s otherwise requested by our customers. Shipping charges 
^generally run *about $4^60 ^of ? a fulT set (7 pounds). C.O.D. orders are an additional 
$1.50’ for UPS delivery: ‘ ° 13 ‘ j 

To order you may ctfVl faur tbfllnumbeK 1-800-528-7070 (Arizona, dial 790-7141). 
Payment can be made by MasterC#d^ Vi'SAi money order, cashier's check, C.O.D., or by personal 
check (we must hold personal checks ten days). We are sorry, but we do not accept 
American Express cards. You may also order byfsending us your order, along with charge 
information, check, or money order. j 


handling. 

What do I need to operate valFORTH? 


a 


valFORTH operates on the Atari 400 or 80Q 
plus one or more packages requires 32K minimunj 
working space. All packages are on disk.' 1 

What Hn T Hn if t have te c hnical questicHfefo J ; 


As a note to your friends who may be interested in valFORTH, to get information and 
the bumper sticker advertised in Creative Computing, you must send us a self-addressed, 
stamped envelope of business size, arid, 254 in coin. Requests without these cannot be 
proceed. ‘ i 

> Thank ydu^idryour interest! ■ 
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Information Sheet 


Despite the explosion of interest in Forth, many programmers are not yet 
familiar with what it is and how it compares to other popular languages. What 
follows is a brief introduction to Forth in general and valFORTH in particular. 

What is Forth? 

It is a stack oriented, high level language in which the user adds to the <• 
basic kernel of commands by defining words (commands) of his/her own. t m*; 

How f ast is it and why? 

Very fast. Forth typically executes ten to twenty times faster than other 
interpreted languages, primarily because of the very small size of the ii interpreter 
itself. Pascal or Basic interpreters are usually at least two thousand bytes 
long. The Forth interpreter is only about 30 bytes. 

I s there more than one version of Forth available? * i 

Yes, there are several. These include the original Fig Forth as well as 
versions available from Quality Software, Atari (Apex), Pink Noise Studios, and 
others for the Atari. There are still others available for Apple, TrRS-BO, and 
many other machines. One of the real advantages of Forth is that it caw* be ef¬ 
fectively implemented (and is) on so many different kinds of computers* 

What^abou t Machine Code? ' , , 

Forth offers the ability, to mix high-level and machine code.io an extreme1y 
simple manner. valFORTH provides one of the most flexible 6602 assemblers found 
anywhere. . , ;f 

What arft the .main a dvantages of Forth? 

- It executes,very fast 

- It is fast to write, because the user can customize it for 
his/her own needs 

- It allows total control of every function of your computer 

- It is frugal with memory 

- It uses structured codei and so can be modified,or debugged 

module.-by, module ^ 

What are the disadvantages? , ; , lo 

The main one is that, because of its power, FORTH is somewhat more difficult 
for people to learn, then, say, Basic. 





How does valFORTH use memory? 


The basic valFORTH system occupies only about 9K of RAM, up to about address 
10600 decimal, plus 2K of removeable buffers. In addition, more than 30K (compiled) 
of very useful additional words are available for loading as desired. The memory 
requirements noted in the valFORTH advertisements are merely the suggested system 
sizes which allow about 10 to 14K remaining RAM for "normal" game program and video 
memory requirements. In Forth, this is a substantial amount of memory for applica¬ 
tions purposes. 

Does valFORTH use documented Atari operating system calls? 

Yes, exclusively! 

Can 1 back up my valFORTH diskettes? 


Yes, all of the software packages are on copiable diskettes, one package 
per diskette. You can make back-up copies or create combinations of compiled 
utilities on a single bootable diskette as you desire. Both software and 
instructions.for this are included. 

What are my requirements if I use valFORTH to write software for sale? 

-- 7fr —- 

Wje^BSSume, because of the inherent power of our software, that it will be 
extensively used for commercial software development. We applaud and encourage 
such use and place only two requirements on it. 

1. That the software or documentation contain a notice indicating that 
valFORTH/fig-Forth was used for developing the product(s). The 
warding for this notice is contained in documentation. 

2. That the procedure included with valFORTH, or an equally secure 
procedure, be used to protect the valFORTH materials which are 
inherent in the product itself. 

There are no licensing or royalty agreements required for such use, as long 
as the valFORTH materials themselves are not sold. Valpar will make every effort 
to support those using valFORTH for product development. 

How about documentation? 


Our staff has worked very hard to provide some of the best documentation 
available. The over 350 pages of materials provided with the full set are 
neatly printed and housed in an attractive binder for your convenience. Much 
tutorial material and many excellent examples are included for the novice, in 
addition to a wealth of more technical information, best suited to the needs 
of the professional programmer. If there is better documentation available 
anywhere we haven't been able to find it. 


U pdates available? 


Yes n — ^will he ^ntiflufftrily imp™** in q and ^vend i ng valFORTH for our in - 
hous e s oftware -develoomeft L. It is uur f r r ten Li 1 caTvt~chancie s 

a nd - i m prov e ments a vaff alfte-ta ottr ctr st ome rs -esthey- are~eva4lable._Ihere-wi+V 

be announc e m e nt s of those improv e m e nts and updat e cost s- w i ll be - l o w, pri marily- 3 - 

- r qypn n q .euajLrActc , HnrnmanfaHnn flnf | s hipping and hand! 
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PRODUCT DESCRIPTION 

jjhis package is a stand-alone fig-FORTH system for the Ptari 
400/800. It is bootable and operates independently of Ptari 
DOS. Ps with virtually all FORTH implernentations, it provides 
its own operating system and disk access words. 

Pll speed-critical , stack, arithmetic, and system words have 
been recoded in machine language for high speed, which gives 
valFORTH 1.1 an immediately noticeable speed advantage over 
other Ptari Forths. 

The package includes: 

two edlitors (the standard fig editor and a 
stripped-down version of the full valFORTH Editor 
available on the Utilities/Editor package); 

an advanced 6502 macro assembler in FORTH, a decompiler 
for FORTH and a visible stack (signed or unsigned); 

many ii^pb,rt ; ant systems words like PICK, ROLL, (CMOVE, 

4 ; /LOOP,/ f;tc. f have been added as used in the excellent 
beginners book, STPRTING FORTH by Leo Brodie; 

graphics and ^ound. commands, all expanded from the 
BPSlC s*tr, . anc| owing, for instance, simplified text 
output .to graphics ,.^1 5 and 2 screens, and user selection 
of default background color when in graphics 0; 

printpr and/or video display output options, disk-copy 
routines* support of OS ROM calls for OPEN and CLOSE, 
t download of RS-232 drivers; 

simple saving of “work" systems for system rebooting 
instead of time-consuming recompilation; 

an auto-boot utility for creating protected, 
distributable software, on disM or cassete, without any 
requirement for licensing feesby Valpar. 

approximately 110 pa^ef of documentation, including a 
get-acquainted section called “Strolling through 
valFORTH 1. 1, “ source code listings for all words 
except the valFORTH 1.1 kernel itself, and handy 
referencevcards on heavy stock. 

vaTFORTH oa l. T is an exceptional value for hobbyist or 
professional. 
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| v PRODUCT DESCRIPTION I 

This package loads on top of valFORTH 1.1. It provides 
extensive development support for the serious programmer as 
well as additional Otari 400/800-specific routines which make 
possible* many of the obscure "tricks" possible with the" r 1 ' 

hardware. 0 Source code listing is provided for the entire 
disk. The futilities includes * ' ’ :H 

4 types" of "case” statements for simple Implementation" ;1 
of complex conditional branching situations! 

4 tyfif^j^f , arrays f allowing f laxijble ; dpta ( , compi lation 
and retrieval; rf , 

miscellaneous utilities including machine coded STICK- * 
and PADDLE read routines, extensive random numbed * 

support (including "pick one in a range, " and array ^ r 

"shuffling”), simple reading of the main system timer, * 

block-and, block-or, block-xor, block screen, move on, a 
single ^disk or between disks, mult ip1e-sectori 

disk-to/from-memory read/write, bit manipulation words, 
etc., - • *-? - - *.<• - 

extensive- support of double—numbers, as per STARTTNGM 
FORTH;' ■ ' •' ’ : 

a Very complete string creation and manipulation^^ 
package including keyboard input with various optiAns, 1 
string^t6-humber ahd number-to-string conversions fiamed 
aft eir their BRSIC counterparts, string operatoVS 

(compare, ‘ moVe, concatenate, search, exchange, store, 
fetch*; 'etc; ), and string-constants and variables; ; * 

"transient structures^ 11 whigh al low srna 11 er. t final 

program size, as , pompi lat ion-oply i^iord.s, ^may be 

discarded with the transient area when no lojngp^ needed ... 

(a state-o^-the-art featured; ^ _ // t 

implpjnentation of text-on-hires displays fg^aphJcs > 

only) ; ." % it ■ # 


The Editor"ib this package is one of the most powerful,and 
convenient available in any FORTH system today, and eases 
programming^ fatigue^, significant ly. Editor features includes , ^ 
Replacesand insectsmode with cursor indication of mode, > * 

and do lets-, and insert-line with "oops", command to ,. • *. 

recover unintentional/Ly; lost lines; . ; 

erase^tb-end-of-1ine, split" ^line, write chain arrowy - J j 
remove * J ehain : arrow, - 'tp-curor, down-cursor; * ; 

right ^cursor,' left—Cursor; J - ; ;I ^ ’ 

multiple-line buffer (up to 330 lines, user selectable 
and memory permitting) with 5 lipe visible^ window onto 
tb,e buffer aihd buffer commands such /as" tp-buffer, ; [' 

from-buffer, rotate buffer, copy-buffer, etc. jj/'; M ‘ 

edit next screen, edit previous screen,; reT e diid £he 
last screen edited; 

greatly enhanced , versions . of WHERE and LOCATE which ' 
pinpoint errors and definitions; 

approximately 60 pages of documentation with r handy 
reference cards on heavy stock. Requires valFORTH 1.1. 
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PRODUCT DESCRIPTION 

This graphics system is one of the most comprehensive graphics 
jpackages ever offered on a micro. fit its heart is a COMPLETE 
{replacement of the functions of the Atari OS graphics routines 
jby new code embodying many major advances. The capabilities of 
jthis new system include, but are not limited to: 

5 * Line drawing routines several times faster than BASIC’ 

* Fill routines fill left AND/OR right 

* "Spine” line on fill may be different from fill color 

* All draw and fill functions may operate as XQR '* 
instead of replace, allowing erase-by-redraw 

J * Special option allows drawing to and through corners 
without art ifacting 

* Fills AND draws may at user option proceed over areas 
already colored. Or may stop optionally at a specific 
color or the absence of a specific color. 

* Complete support for the unsupported (in BASIC! - - 
graphics mode 7+ (also known as ”7 and a half") which 
is Antic mode 14. , This- r mode is called up like any 
other by the command 12 GR. and is used v for example,, . 
in the cartidge'version of Missi1e Command; from Atari.. 

* Draw and, fill commands now work i n wi de. and narrow . 
screen mpjdes, $swell as in the normal screen, wi^th.^ f 

* A very extensive set of windowing functions ha^jbeen 

provided to allow clipping and scaling, windows within 
windows within Windows, and so on. r ' " r 

* Turtle graphics has beeh s expanded’’-‘with 7 Several 
commands like turn-toward ( TURNTWD ) which allbws 
pointing the turtle toward an arbitrary point, artd 
2-1 ihe-intersest ion V ' 2LNX ) which allows "pendi 1 and 
straight edge" type graphical construction. 

* Extensive window-, point- and line-naming words have 
been provided for simpler program conceptualization. ^ 

Besides the graphics package briefly described £ above, also 
provided are trigonometric function extensions to the core 
floating point set in valFORTH 1.1, along with various patches 
around Atari OS shortcomings in dealing with overflow and 
underflow of floating point computat ions. r Also provided, are 
integer versions of sine, cosine, and arctangent functions that 
allow the user to trade accuracy for speed in trigonometric 
computations. 

Finally, this package^is based on a new high-speed, low-memory 
consumption, state-o+-the-art FORtil data, structure called QUAN 
which was developed at Valpar to replace the VARIABLE construct 
and appears hihfr ’fdh the first time. 

Over 60 pages of documentation including 16 pages of examples. 
Requires, valFORTH 1.1 
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PRODUCT DESCRIPTION 

The software in this package grew out of text handling needs at 
Valpar itself as well as out of discussions with various 
adventure game authors about their own needs. This package can 
be very useful in any application that has to perform a 
significant amount of text output. In addition, the coding 
strategy was designed for almost immediate transfer to other 
fig-FORTH systems, even on other processors. 


Two different approaches to "text compression" are used. ' : The 
first method stores messages on disk* encrypting them first if 
this user option has been selected. Messages may be recalled 
from disk (decrypted ajs necessary) by executing Message names 
which were defined at compile time. The second text compression 
method utilises some advanced FORTH . techniques to^*'achieve 
in-memory coding of message material and is useful when a 
program must run without access to disk. 

Pfter either'type of compressed text discussed above has been 
retrieved the' text may be routed through the automatic 
formatting routines. These routines will format and output the 
text to video display, printer, or both, in accordance with 
various user-selected options. Putoformatting options includes 


Left, right, center, and fill just ification. 
Variable-color output in colored modes 


cap-next and cap-lock 

Inverse video and/or inverse background. 

Formatting for video display, either through TYPE or 
through a "window.;, formatter which allows different 
messages to be presented at different areas of the 
* screen, with automatic scrolling as required. 

Formatting for printer output. 

.This package is a must for virtually ary extensively 
text-oriented or "talky" application on thfe ©tari. 


Requires valFORTH 1. 1 



